home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 176-200 / scopedisk185 / hermit13 / hermit.doc < prev    next >
Text File  |  1995-03-19  |  12KB  |  237 lines
  1.  
  2.                           HERMES' HERMiT (Version 1.3)
  3.  
  4.                      Copyright (c) 1988-91 A. G. Kartsatos
  5.                                  
  6.                                   (Shareware)
  7.  
  8.         ((Saves/Cycles The Front Screen, Saves The Front Screen's Font,
  9.                Saves And Provides Code For The Front Window's
  10.                     As Well As The Preferences' Pointer,
  11.                      Opens A CLI On The Front Screen))
  12.  
  13.     Here is a new version of HERMiT.  This time HERMiT will also open a CLI
  14. on top of your Front Screen and will save your Front Window's Pointer in a
  15. system-configuration file.  It will also provide C code for the Front
  16. Window's as well as the Preferences' Pointer.  The old features are of course
  17. course still here: Saving of Front Screens, Cycling of Front Screens and 
  18. Saving of the Fonts of Front Screens.
  19.     The user should read this manual in its entirety in order to avoid
  20. unnecessary complications and frustration.  For example, you can read below
  21. how you may save the front screen although the usual key combination does
  22. not work because another running program is using it.
  23.  
  24.     ***It works from the Workbench or the CLI.  To run it from the CLI, just
  25. press RUN HERMiT.  Just click into its icon when you you want it to run from
  26. your Workbench.***
  27.  
  28.     LALT denotes the Left ALT KEY on your keyboard.
  29.     To start HERMiT operating, you must enter a volume/directory where you
  30. want your pictures and fonts saved.  No actual filenames are needed and they
  31. will not work.  For example, assume that you want your pictures saved in
  32. the directory DF0:Pictures.  To guarantee this, just enter DF0:Pictures in 
  33. the gadget of the HERMiT screen and PRESS <RETURN>.
  34.  
  35.      In what follows, "Flash" means "sun the screen."
  36.  
  37.      COMMANDS:
  38.  
  39.     (I)  CTRL+LALT+S:  Saves The Front Screen. (Flashes before and after)
  40.  
  41.     This is a very useful feature when you need a copy of a screen of
  42. a word processor, a game, a utility, etc.  It saves OVERSCAN front screens
  43. too. The files are saved sequentially like GRABBiT to a directory/volume path
  44. that you specify when the HERMiT requester asks you for it.  The saving 
  45. format: HR_3MED.000 = HERMiT, 3 Planes, Medium Resolution, File Number 0.
  46. Another example: HR_6LACE.007 = HERMiT, 6 Planes, INTERLACE Mode, 8th File
  47. Saved.  Whenever HERMiT is run, the numbering of the pictures starts from
  48. 000.  This means that the user should make sure that he/she does not
  49. overwrite older pictures with the same number, resolution and planes as
  50. the new ones.
  51.  
  52.    (II)  CTRL+LALT+1, CTRL+LALT+2, CTRL+LALT+3:  Cycles Pictures At 3 Diffe-
  53.                                                  Speeds.
  54.          TAB KEY:  Stops The Cycling.
  55.  
  56.     HERMiT will cycle IFF pictures which with 8 to 32 colors (2-5 planes).
  57.     It will cycle the colors of the front screen at three different speeds
  58. corresponding to the above 3 key combinations.  The only uncycled color is
  59. the color in register 0.  It is usually the color outside the picture frame
  60. and it does not look good when you include it in the cycling.
  61.     Press the TAB KEY to stop the cycling.
  62.  
  63.   
  64.   (III)  CTRL+LALT+F:  Will Save The Front Screen's Font. 
  65.                        (Flashes Before And After)
  66.  
  67.     Well, all these Front-Screen saving operations are of course possible
  68. only when the running program allows you to do them.  When the running prog-
  69. ram uses the "Disable(), Forbid()" combinations (e.g., in the C Language),
  70. you cannot save the FrontScreen.
  71.  
  72.     To SAVE THE FONT, just PRESS: CTRL+LALT+F.  The program will check first
  73. to see if the font is just the TOPAZ one.  If it is, the program will notify
  74. you accordingly, and it will not save the font.  Let us assume that the font
  75. has the name HELLO and has size 11.  The program will try to see if a 
  76. directory exists in the assigned HERMiT path (above) with the name fonts.
  77. If it exists, HERMiT will try to save the font in there.  It will put a file
  78. called HELLO.font in that fonts directory, it will then open a directory
  79. in there with the name HELLO, and, finally, it will place into the HELLO
  80. directory a file with the name "11".
  81.  
  82.      If the fonts directory cannot be found in the assigned HERMiT path,
  83. HERMiT will create it and continue as above.
  84.  
  85.      The program WILL NOT CREATE A FONT IF THE FONT NAME ALREADY EXISTS IN
  86. THE HERMiT PATH/FONTS DIRECTORY.  This means that if there is a HELLO font
  87. already in that fonts directory, HERMiT will not create a font with the
  88. name HELLO even if the new font has a different size.
  89.  
  90.      If you do want to get that font anyway, just change the names of the
  91. three files of the HELLO font that are already there (HELLO.font, HELLO
  92. and 11), or delete them.
  93.  
  94.      Now, I do not really want to play with your current "fonts" directory.
  95. So, when you enter a path into the HERMiT gadget, please avoid entering
  96. a volume/directory that contains your valuable "fonts" directory.  This of
  97. course applies only when you are planning to save the screen font.
  98.  
  99.    (IV)  CTRL+LALT+P:  Saves The Front Window's Pointer.
  100.                        (Flashes Before And After)
  101.  
  102.      This of course means that THERE IS a pointer attached to your front
  103. window.  If there is no such pointer, HERMiT will notify you accordingly.
  104.      Also, HERMiT will not save your pointer if it is too large.  This means
  105. that if your pointer has width and/or height bigger than 16, HERMiT will tell
  106. you that your pointer is too large and will refrain fromm trying to save it.
  107.      *However, HERMiT will give you the C code for such an oversized pointer
  108. that you can use in your programs.*
  109.      HERMiT saves the pointer in a copy of your "system-configuration" file.
  110. This file resides in your "devs" directory and contains the entire current
  111. Preferences data of your machine.  HERMiT's copy is in the directory/drive
  112. thar has been initially specified by you and is named "HR_CONF".  REMEMBER:
  113. "HR_CONF" is a BINARY file.  In order to see the pointer this way, you just
  114. use the enclosed program "ShowPointer".  Just press "ShowPointer HR_CONF" and
  115. the program will set your pointer to the one in "HR_CONF".  This "ShowPointer"
  116. program will work with any system-configuration files that contain pointers
  117. of legitimate dimensions as above.  If you want the shown pointer to perma-
  118. nently become your pointer, just run the Preferences file and then save it.
  119. That's it!
  120.      Besides the image of the pointer, HERMiT will also save the colors of it.
  121. These are in color registers 17,18, and 19.
  122.  
  123.     (V)  CTRL+LALT+D:  Provides C Code For The Front Window's Pointer
  124.                        As Well As The Preferences' Pointer.
  125.                        (Flashes Before And After)
  126.  
  127.      This feature allows you to obtain the C code for the pointer if you want
  128. to use it in your own programs.  If the front window has no pointer attached
  129. to it, HERMiT will give you the C code for the pointer obtained from your
  130. Preferences (and not from your "devs:system-configuration" file).
  131.      If the front window has a pointer attached to it, HERMiT will give you
  132. the C code for that pointer.  In either case, the file containing the C code
  133. resides in your pre-specified directory/drive and has the name: "HR_PTRCODE".
  134.      *HERMiT will give you the C code also for oversized pointers that you
  135. can use in your programs.*
  136.  
  137.    (VI) CTRL+LALT+C:  Opens A New CLI On Top Of The Front Screen.
  138.     
  139.     HERMiT will open a new CLI on top of the front screen.  Naturally, this
  140. CLI will have the resolution of the top screen.  Please DO NOT MOVE THE TOP
  141. SCREEN OR THIS CLI TO THE BACKGROUND because you MIGHT LOSE THE CLI and the
  142. ability to further use HERMiT.  This can happen in resolutions other than
  143. HIRES (640x200).  So, use the CLI as you please (entering commands into it),
  144. and PRESS: ENDCLI to get rid of it when you are done.  Obviously, the file
  145. EndCLI should be in your c directory.  EndCLI is the only way to get rid
  146. of this new CLI.  HERMiT will not open a new CLI whenever your screen's
  147. width is smaller than 250.  If you do not get a new CLI this way, it means
  148. that HERMiT cannot open the window in the present environment.
  149.    HERMiT checks to see if you have the NewCLI command in your c directory.
  150.    If you do, HERMiT runs that command and gives you a NewCLI with the reso-
  151. lution of your front screen.  If you do not, HERMiT will open its own CLI
  152. on your front screen.  Both types of CLI will be "smart" when HERMiT is run-
  153. ning from the CLI.  However, when HERMiT is running for the Workbench,
  154. either type of CLI will not be as smart.  They will recognize all the commands
  155. in your assigned c directory, but not the commands from the path.  Naturally,
  156. in such a case you may still run a path command inside the CLI to establish
  157. the path that you desire.
  158.  
  159.   (VII)  CTRL+LALT+H:  Checks Whether HERMiT Has Been Activated. (Flash)
  160.  
  161.  (VIII)  CTRL+LALT+Q:  Stops HERMiT From Running In The Background. (Flash)
  162.                        Same effect by pressing: "HERMiT Q".
  163.  
  164.      If, for some reason, HERMiT does not get off with this triplet of KEYS,
  165. you might still be able to "KILL" it by just pressing: "HERMiT Q".  In this
  166. case HERMiT sends an input event message to the entire input device to make
  167. sure that the keys are going to be "listened" to by the running copy of 
  168. itself.
  169.  
  170.      Now, remember that it is still possible to have HERMiT blocked from
  171. operation because another running program MAY BE USING SOME OF THE ABOVE KEY
  172. COMBINATIONS.  So, if you get stuck trying to save a picture with HERMiT,
  173. have this fact in mind.  You might be able to still save a picture though.
  174.  
  175.      HERMiT WILL SAVE THE SCREEN AFTER 20 SECONDS WITHOUT PRESSING ANY KEYS!
  176.  
  177.      If you want to save the screen of a program 20 seconds after you run 
  178. HERMiT, just run HERMiT as follows: HERMiT 20.
  179.  
  180.      The program will notify you that it is waiting for about 20 seconds 
  181. before it saves the front screen.  This will give you plenty of time to get to
  182. the desired screen.  After it saves the screen, HERMiT will be operating as
  183. usual.  If you specify any number of seconds other than 20, the program
  184. will default to 20 seconds.
  185.  
  186.      One of the main reasons for not being able to save certain screens, is
  187. that the programs creating those screens block your keyboard and prohibit
  188. you from interfering with their respective tasks.  This can be done in 
  189. the C language by using instructions like "Disable(); Forbid();".  HERMiT
  190. will not be able to help in such cases.  Actually, no known program will.
  191.      The HERMiT icon opens a small "CON:" window on your screen to accept the
  192. output.  If you really want to see that output, just extend that window as
  193. much as you please.  You can do that by changing the dimensions of that
  194. window.  Just "Info" the icon and make the change.
  195.      I have tried to cover a lot of cases of possible ... misuse of the
  196. program.  However, if you come across any situations at all where HERMiT
  197. does not work properly, please let me know.  I would appreciate it.
  198.  
  199.      I would like to express my thanks to Robert Miles (Excalibur BBS,
  200. Dallas) for sharing his knowledge with me on the hunks of executable files.
  201.  
  202.      Have fun!!!
  203.  
  204.                  @@-->>> HERMES
  205.  
  206.      This program has been released under the SHAREWARE concept.  If you
  207. find it useful, please send $15.00 to the following address.  You can use
  208. the same address for SUPPORT on other programs by hERMES.
  209.  
  210.      A. G. Kartsatos      (...Author Of IconLab 1.3 And LoGG 1.0)
  211.      8524 Caladesi Island Drive
  212.      Temple Terrace, FL 33637-7310, USA
  213.  
  214. DISTRIBUTION:
  215. =============
  216.  
  217.      Feel free to distribute this version of HERMiT, WITH THIS DOC INTACT,
  218. to any bulletin boards and non-profit establishments in the US and
  219. abroad.
  220.      You are also allowed to upload this version to major electronic boards
  221. like BIX, Compuserve, Delphi, GEnie, PLink, etc.
  222.      The inclusion of HERMiT, or any part of it, in any form in a commercial
  223. package, or its use for any commercial purposes, is illegal without the ex-
  224. plicit permission of the author.
  225.      Most nationally and internationally sold disks with Amiga software are
  226. considered commercial packages by this author.  Only The Amiga User Group
  227. "Disk Of The Month" disks are excluded.
  228.  
  229. DISCLAIMER:
  230. ===========
  231.  
  232.      The usual disclaimers concerning computer software apply to this
  233. product.
  234.      Although this program has been tested extensively for its accuracy and
  235. reliability, the author will accept no liability whatsoever for damage
  236. resulting from the use, misuse, or excessive use of it.
  237.